From da6b6d44c1f4c93b6895ec8495188f76e49668d8 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Mon, 1 Mar 2021 01:50:44 -0500
Subject: [PATCH] multiselection: Convert docs

---
 gtk/gtkmultiselection.c | 36 +++++++++++++++++-------------------
 1 file changed, 17 insertions(+), 19 deletions(-)

diff --git a/gtk/gtkmultiselection.c b/gtk/gtkmultiselection.c
index 70ee6ea8bb..2b60ab8302 100644
--- a/gtk/gtkmultiselection.c
+++ b/gtk/gtkmultiselection.c
@@ -26,13 +26,10 @@
 #include "gtkselectionmodel.h"
 
 /**
- * SECTION:gtkmultiselection
- * @Short_description: A selection model that allows selecting multiple items
- * @Title: GtkMultiSelection
- * @see_also: #GtkSelectionModel
+ * GtkMultiSelection:
  *
- * GtkMultiSelection is an implementation of the #GtkSelectionModel interface
- * that allows selecting multiple elements.
+ * `GtkMultiSelection` is a `GtkSelectionModel` that allows selecting multiple
+ * elements.
  */
 
 struct _GtkMultiSelection
@@ -347,9 +344,9 @@ gtk_multi_selection_class_init (GtkMultiSelectionClass *klass)
   gobject_class->dispose = gtk_multi_selection_dispose;
 
   /**
-   * GtkMultiSelection:model:
+   * GtkMultiSelection:model: (attributes org.gtk.Property.get=gtk_multi_selection_get_model org.gtk.Property.set=gtk_multi_selection_set_model)
    *
-   * The list managed by this selection
+   * The list managed by this selection.
    */
   properties[PROP_MODEL] =
     g_param_spec_object ("model",
@@ -370,12 +367,12 @@ gtk_multi_selection_init (GtkMultiSelection *self)
 
 /**
  * gtk_multi_selection_new:
- * @model: (allow-none) (transfer full): the #GListModel to manage, or %NULL
+ * @model: (allow-none) (transfer full): the `GListModel` to manage, or %NULL
  *
  * Creates a new selection to handle @model.
  *
- * Returns: (transfer full): a new #GtkMultiSelection
- **/
+ * Returns: (transfer full): a new `GtkMultiSelection`
+ */
 GtkMultiSelection *
 gtk_multi_selection_new (GListModel *model)
 {
@@ -394,8 +391,8 @@ gtk_multi_selection_new (GListModel *model)
 }
 
 /**
- * gtk_multi_selection_get_model:
- * @self: a #GtkMultiSelection
+ * gtk_multi_selection_get_model: (attributes org.gtk.Method.get_property=model)
+ * @self: a `GtkMultiSelection`
  *
  * Returns the underlying model of @self.
  *
@@ -410,13 +407,14 @@ gtk_multi_selection_get_model (GtkMultiSelection *self)
 }
 
 /**
- * gtk_multi_selection_set_model:
- * @self: a #GtkMultiSelection
- * @model: (allow-none): A #GListModel to wrap
+ * gtk_multi_selection_set_model: (attributes org.gtk.Method.set_property=model)
+ * @self: a `GtkMultiSelection`
+ * @model: (allow-none): A `GListModel` to wrap
+ *
+ * Sets the model that @self should wrap.
  *
- * Sets the model that @self should wrap. If @model is %NULL, @self
- * will be empty.
- **/
+ * If @model is %NULL, @self will be empty.
+ */
 void
 gtk_multi_selection_set_model (GtkMultiSelection *self,
                                GListModel        *model)
-- 
2.30.2